<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This file documents the GNU Assembler "as".

Copyright (C) 1991-2016 Free Software Foundation, Inc.

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, with no Front-Cover Texts, and with no
Back-Cover Texts.  A copy of the license is included in the
section entitled "GNU Free Documentation License".
 -->
<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
<head>
<title>Using as: CRIS-Pic</title>

<meta name="description" content="Using as: CRIS-Pic">
<meta name="keywords" content="Using as: CRIS-Pic">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="AS-Index.html#AS-Index" rel="index" title="AS Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="CRIS_002dSyntax.html#CRIS_002dSyntax" rel="up" title="CRIS-Syntax">
<link href="CRIS_002dRegs.html#CRIS_002dRegs" rel="next" title="CRIS-Regs">
<link href="CRIS_002dChars.html#CRIS_002dChars" rel="prev" title="CRIS-Chars">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="CRIS_002dPic"></a>
<div class="header">
<p>
Next: <a href="CRIS_002dRegs.html#CRIS_002dRegs" accesskey="n" rel="next">CRIS-Regs</a>, Previous: <a href="CRIS_002dChars.html#CRIS_002dChars" accesskey="p" rel="prev">CRIS-Chars</a>, Up: <a href="CRIS_002dSyntax.html#CRIS_002dSyntax" accesskey="u" rel="up">CRIS-Syntax</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="AS-Index.html#AS-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Symbols-in-position_002dindependent-code"></a>
<h4 class="subsubsection">9.8.4.2 Symbols in position-independent code</h4>
<a name="index-Symbols-in-position_002dindependent-code_002c-CRIS"></a>
<a name="index-CRIS-symbols-in-position_002dindependent-code"></a>
<a name="index-Position_002dindependent-code_002c-symbols-in_002c-CRIS"></a>

<p>When generating <a name="crispic"></a>position-independent code (SVR4
PIC) for use in cris-axis-linux-gnu or crisv32-axis-linux-gnu
shared libraries, symbol
suffixes are used to specify what kind of run-time symbol lookup
will be used, expressed in the object as different
<em>relocation types</em>.  Usually, all absolute symbol values
must be located in a table, the <em>global offset table</em>,
leaving the code position-independent; independent of values of
global symbols and independent of the address of the code.  The
suffix modifies the value of the symbol, into for example an
index into the global offset table where the real symbol value
is entered, or a PC-relative value, or a value relative to the
start of the global offset table.  All symbol suffixes start
with the character &lsquo;<samp>:</samp>&rsquo; (omitted in the list below).  Every
symbol use in code or a read-only section must therefore have a
PIC suffix to enable a useful shared library to be created.
Usually, these constructs must not be used with an additive
constant offset as is usually allowed, i.e. no 4 as in
<code>symbol + 4</code> is allowed.  This restriction is checked at
link-time, not at assembly-time.
</p>
<dl compact="compact">
<dt><code>GOT</code></dt>
<dd>
<p>Attaching this suffix to a symbol in an instruction causes the
symbol to be entered into the global offset table.  The value is
a 32-bit index for that symbol into the global offset table.
The name of the corresponding relocation is
&lsquo;<samp>R_CRIS_32_GOT</samp>&rsquo;.  Example: <code>move.d
[$r0+extsym:GOT],$r9</code>
</p>
</dd>
<dt><code>GOT16</code></dt>
<dd>
<p>Same as for &lsquo;<samp>GOT</samp>&rsquo;, but the value is a 16-bit index into the
global offset table.  The corresponding relocation is
&lsquo;<samp>R_CRIS_16_GOT</samp>&rsquo;.  Example: <code>move.d
[$r0+asymbol:GOT16],$r10</code>
</p>
</dd>
<dt><code>PLT</code></dt>
<dd>
<p>This suffix is used for function symbols.  It causes a
<em>procedure linkage table</em>, an array of code stubs, to be
created at the time the shared object is created or linked
against, together with a global offset table entry.  The value
is a pc-relative offset to the corresponding stub code in the
procedure linkage table.  This arrangement causes the run-time
symbol resolver to be called to look up and set the value of the
symbol the first time the function is called (at latest;
depending environment variables).  It is only safe to leave the
symbol unresolved this way if all references are function calls.
The name of the relocation is &lsquo;<samp>R_CRIS_32_PLT_PCREL</samp>&rsquo;.
Example: <code>add.d fnname:PLT,$pc</code>
</p>
</dd>
<dt><code>PLTG</code></dt>
<dd>
<p>Like PLT, but the value is relative to the beginning of the
global offset table.  The relocation is
&lsquo;<samp>R_CRIS_32_PLT_GOTREL</samp>&rsquo;.  Example: <code>move.d
fnname:PLTG,$r3</code>
</p>
</dd>
<dt><code>GOTPLT</code></dt>
<dd>
<p>Similar to &lsquo;<samp>PLT</samp>&rsquo;, but the value of the symbol is a 32-bit
index into the global offset table.  This is somewhat of a mix
between the effect of the &lsquo;<samp>GOT</samp>&rsquo; and the &lsquo;<samp>PLT</samp>&rsquo; suffix;
the difference to &lsquo;<samp>GOT</samp>&rsquo; is that there will be a procedure
linkage table entry created, and that the symbol is assumed to
be a function entry and will be resolved by the run-time
resolver as with &lsquo;<samp>PLT</samp>&rsquo;.  The relocation is
&lsquo;<samp>R_CRIS_32_GOTPLT</samp>&rsquo;.  Example: <code>jsr
[$r0+fnname:GOTPLT]</code>
</p>
</dd>
<dt><code>GOTPLT16</code></dt>
<dd>
<p>A variant of &lsquo;<samp>GOTPLT</samp>&rsquo; giving a 16-bit value.  Its
relocation name is &lsquo;<samp>R_CRIS_16_GOTPLT</samp>&rsquo;.  Example: <code>jsr
[$r0+fnname:GOTPLT16]</code>
</p>
</dd>
<dt><code>GOTOFF</code></dt>
<dd>
<p>This suffix must only be attached to a local symbol, but may be
used in an expression adding an offset.  The value is the
address of the symbol relative to the start of the global offset
table.  The relocation name is &lsquo;<samp>R_CRIS_32_GOTREL</samp>&rsquo;.
Example: <code>move.d [$r0+localsym:GOTOFF],r3</code>
</p></dd>
</dl>

<hr>
<div class="header">
<p>
Next: <a href="CRIS_002dRegs.html#CRIS_002dRegs" accesskey="n" rel="next">CRIS-Regs</a>, Previous: <a href="CRIS_002dChars.html#CRIS_002dChars" accesskey="p" rel="prev">CRIS-Chars</a>, Up: <a href="CRIS_002dSyntax.html#CRIS_002dSyntax" accesskey="u" rel="up">CRIS-Syntax</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="AS-Index.html#AS-Index" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>
